home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / lisp / clue.lha / clue / doc / clue.tex / node200_mn.html < prev    next >
Text File  |  1989-07-12  |  3KB  |  83 lines
  1.  
  2. <H3><A ID="SECTION005611100000000000000">
  3. Shell State</A>
  4. </H3><#5267#>
  5.            
  6.       
  7.  
  8. <A ID="2781"><tex2html_anchor_invisible_mark></A><A ID="2782"><tex2html_anchor_invisible_mark></A>
  9. The possible values for the <#2783#><TT>contact-state</TT><#2783#> of a shell
  10. differ slightly from those of ordinary contacts. Because the parent of a
  11. shell is always a <#2784#><TT>root</TT><#2784#>, a shell does not have a geometry manager
  12. in the usual sense. Instead, a window manager client<A ID="2785"><tex2html_anchor_invisible_mark></A> will typically allow the  user to define control the geometry
  13. of shells and other top-level windows interactively. Shell states,
  14. therefore, correspond to the top-level window states defined in
  15. [#icccm#<tex2html_cite_mark>#1##<tex2html_cite_mark>#]:
  16.  
  17. <P>
  18. <DIV class="CENTER">
  19. <TABLE CELLPADDING=3>
  20. <TR><TD ALIGN="LEFT"><TT>:withdrawn</TT></TD>
  21. <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>The shell is invisible and unavailable for input.</TD>
  22. </TR>
  23. <TR><TD ALIGN="LEFT">;SPMnbsp;</TD>
  24. <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>;SPMnbsp;</TD>
  25. </TR>
  26. <TR><TD ALIGN="LEFT"><TT>:iconic</TT></TD>
  27. <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>Same as <TT>:withdrawn</TT>, except that the window manager
  28. may display an alternate visual representation of the shell (for
  29. example, an icon). The exact nature (and even the existence) of this
  30. alternate representation depends on the window manager.</TD>
  31. </TR>
  32. <TR><TD ALIGN="LEFT">;SPMnbsp;</TD>
  33. <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>;SPMnbsp;</TD>
  34. </TR>
  35. <TR><TD ALIGN="LEFT"><TT>:mapped</TT></TD>
  36. <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>The shell is in its ``normal'' state --- mapped and
  37. available for input.</TD>
  38. </TR>
  39. <TR><TD ALIGN="LEFT">;SPMnbsp;</TD>
  40. <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>;SPMnbsp;</TD>
  41. </TR>
  42. </TABLE>
  43. </DIV>
  44.  
  45. <P>
  46. Mapping (or ``popping up'') a shell means setting its state to <#2796#><TT>:mapped</TT><#2796#>.<A ID="2797"><tex2html_anchor_invisible_mark></A>  Unmapping
  47. (or ``popping down'')<A ID="2798"><tex2html_anchor_invisible_mark></A> a shell means setting
  48. its state to <#2799#><TT>:iconic</TT><#2799#> or <#2800#><TT>:withdrawn</TT><#2800#>.
  49. Mapping a shell causes its <#2801#><TT>:map</TT><#2801#> callback to be invoked.
  50. Similarly, unmapping a shell invokes its <#2802#><TT>:unmap</TT><#2802#> callback.  These
  51. callbacks allow the application programmer to change the contents of a
  52. shell before it is mapped or after it is unmapped.  The required
  53. argument list for each of these callbacks is shown below.
  54.  
  55. <P>
  56. <#4706#>
  57. <#4449#><FONT SIZE="+1"><#2803#><B>:map Callback, shell</B><#2803#></FONT><#4449#> 
  58. <A ID="2804"><tex2html_anchor_invisible_mark></A>
  59. <DIV class="RIGHT">
  60. <tex2html_image_mark>#tex2html_wrap_inline10340#
  61. </DIV><#4706#>
  62.  
  63. <P>
  64. <DIV class="RIGHT">
  65. <tex2html_image_mark>#tex2html_wrap_inline10342#
  66. </DIV>
  67.  
  68. <P>
  69. <#4707#>
  70. <#4452#><FONT SIZE="+1"><#2816#><B>:unmap Callback, shell</B><#2816#></FONT><#4452#> 
  71. <A ID="2817"><tex2html_anchor_invisible_mark></A>
  72. <DIV class="RIGHT">
  73. <tex2html_image_mark>#tex2html_wrap_inline10343#
  74. </DIV><#4707#>
  75.  
  76. <P>
  77. <DIV class="RIGHT">
  78. <tex2html_image_mark>#tex2html_wrap_inline10345#
  79. </DIV>
  80.  
  81. <P>
  82.  
  83.  =0 <#5273#>=0 <#5277#>